PHPDoc 和 __callStatic
全部标签 虽然我按照说明安装了phpDocumentor,但命令行似乎没有响应phpdoc给定错误:未找到命令“phpdoc”,您的意思是:来自debphploc的命令'phploc'来自debphpdox的命令'phpdox'尝试:sudoaptinstall我按照这些步骤安装了phpdoc,它似乎可以工作pearchannel-discoverpear.phpdoc.orgpear安装phpdoc/phpDocumentor安装完成后,我尝试运行phpdoc-h但没有成功。使用:7.2.16操作系统:Ubuntu18.04.2LTS我很感激任何帮助的尝试。 最佳答
作为Emacs用户,我唯一羡慕像PDT这样的“现代”编辑器的是PDT理解类型,甚至PHPDoc“类型提示”,例如/***@paramDateTime$date*@paramstring$name*@returnDOMDocument*/目前,我尽可能使用类型提示,让PHP解释器在参数类型错误时提醒我,但这仅在参数是对象时有效。更重要的是,无法确保函数的返回值是特定类型。这可能是一个远景,但是否有任何插件或其他方法可以使PHP解释器以与PDT相同的方式识别PHPDoc注释?理想情况下,如果我返回一个错误类型的值,或者如果我传递一个我已将参数声明为int的字符串,我希望得到fatalerr
这个问题在这里已经有了答案:关闭11年前。PossibleDuplicate:IsthereastandardfordocumentingGET/POSTparameters?试图找出以一种有意义的方式通过phpdoc记录请求参数的最佳方式。具体来说,我有一些通过GET/POST接收参数但不是功能参数的ZendFrameworkController操作。这有意义吗?/***Displayapagination/gridlistofrows.**@paramstring$_GET['order']Whatfieldtosorton*@paramstring$_GET['dir']Dire
我应该如何正确使用PHPdoc来记录类中的可链接方法,如以下示例所示-正确用法是什么?classmyClass{/***@returnmyClass*/functionone(){return$this;}/***@returnself*/functiontwo(){return$this;}/***@return$this*/functionthree(){return$this;}} 最佳答案 /***@returnmyClass*/我不是phpDoc专家,但他们在Zend框架中就是这样做的。所以我觉得靠谱
我想知道我应该如何将@package和@subpackage用于类文档。假设我有以下类(class)classMy_Controller_Action_Helper_MyHelperActionextendsFoo_Bar{}应该是:@categoryMy@packageController@subpackageAction_Helper或@categoryMy@packageController@subpackageAction_Helper_MyHelperAction或@categoryMy@packageController_Action@subpackageMyHelpe
谁能告诉我在phpDoc语法中定义php命名空间的正确方法是什么?或者,@package是否在phpDoc中被弃用,因为命名空间或多或少定义了一个包?如果没有,是否有一种通用的方法来记录文档所在的命名空间? 最佳答案 phpDoc没有命名空间的概念,但您可以(并且可能应该)使用@package。你可以看看phplintdocumentation看看他们是如何格式化命名空间的。 关于php-在phpDoc语法中定义命名空间,我们在StackOverflow上找到一个类似的问题:
我无法找到可以用PHPDoc提示的类型的概述。我知道数组或字符串,但还有bool值吗?喜欢:/***@paramboolloadLazy*@returnarrayArraywithobjects*/publicfunctiongetObjects($loadLazy=false){ 最佳答案 由于“类型提示”只是一个“提示”,我想说您可以使用任何您喜欢的东西。不过,我倾向于使用在官方PHP手册中找到的类型——这意味着,对于Boolean,我会使用boolean。 关于php-bool参数
这个问题在这里已经有了答案:PHPDoctypehintingforarrayofobjects?(14个答案)关闭去年。我使用PhpDocumentor2生成文档。我搜索了这个主题,但找不到它的具体规则。例如,我有一个名为AddressField的类,我想将我的$addressFields指定为AddressField对象数组。/***@varAddressField[]*/private$addressFields;
PHPDoc提供了@vartag,它甚至应该适用于在类外声明的变量。但是,如果我将变量定义为对象的魔术成员,这似乎不起作用:/**@var$app->translator\Fortress\MessageTranslator*/$app->translator=new\Fortress\MessageTranslator();$app是Slim支持通过魔术setter和setter/getter进行任意属性分配的对象。我知道我可以通过@property标签将它添加到Slim本身,但是我需要更改核心Slim每次创建新属性时都编写代码。PHPDoc支持这种动态属性文档吗?
假设我有以下内容classSomethingextendsClassWithMagicMethods{}通常我会为我知道存在的任何属性添加一个文档block,即使通过魔术方法访问也是如此/***@propertystring$someVar*@methodSomeClassgetSomeClass()*/classSomethingextendsClassWithMagicMethods{}效果很好,但我想知道我们是否可以将该文档block与类的定义分开。两个可能的用例:不包含文档block的第三方包,但我希望从我的IDE自动完成-我希望能够在某处为其添加我自己的文档block。扩展系